home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / mindos11.zip / MINDOS.TXT < prev    next >
Text File  |  1991-04-05  |  6KB  |  157 lines

  1. $Header: MINDOS.T_V 1.4 91/04/05 15:51:42 SWH Exp $
  2.  
  3.                               MINDOS v1.1
  4.                               ===========
  5.  
  6.  
  7. ********************************************************************
  8. *                                                                  *
  9. *   COPYRIGHT STATEMENT                                            *
  10. *   ===================                                            *
  11. *                                                                  *
  12. *   All the files in this MINDOS package, including, but not       *
  13. *   limited to, sources, executables, documentation, are:          *
  14. *                                                                  *
  15. *   COPYRIGHT 1988,1991 STEVEN W. HARROLD -- ALL RIGHTS RESERVED   *
  16. *                                                                  *
  17. *   You may use this MINDOS package and its components for any     *
  18. *   purpose, except that you are not permitted to sell or          *
  19. *   exchange the contents of the package for remuneration.  You    *
  20. *   may use MINDOS to build other products that you intend to      *
  21. *   make a profit from, but this MINDOS package must not itself    *
  22. *   exchange hands for financial gain.  You may reproduce this     *
  23. *   package for someone else and charge only for the cost of       *
  24. *   materials expended, not to exceed $10.  If you do reproduce    *
  25. *   the package, you must do so only in its entirety, and name     *
  26. *   the result MINDOS11.                                           *
  27. *                                                                  *
  28. *   CAVEATS                                                        *
  29. *   =======                                                        *
  30. *                                                                  *
  31. *   Although I have attempted to provide an error-free package I   *
  32. *   will accept NO LIABILITY for any damages that result from      *
  33. *   your use of the software.                                      *
  34. *                                                                  *
  35. ********************************************************************
  36.  
  37.  
  38. WHAT MINDOS DOES
  39. ================
  40.  
  41. This utility package allows you to read any file inside a Minix File
  42. System (MFS) from MSDOS.  The programs offered are:
  43.  
  44.     MBLOCK.EXE  Display any block in an MFS, in hex
  45.     MDISK.EXE   Tells you the physical attributes of a disk/drive
  46.     MDUMP.EXE   Dumps the blocks controlling the content of a MFS
  47.     MLS.EXE     Presents an 'ls -l' listing of MFS contents
  48.     MREAD.EXE   Reads a file in an MFS and copies to DOS file system
  49.  
  50.  
  51. CONTENTS OF ARCHIVE
  52. ===================
  53.  
  54. The contents of the archive are:
  55.  
  56.     MINDOS.TXT      This file (the one you're reading)
  57.     MANIFEST        List of source files and revisions used
  58.     MAKEFILE        Makefile to recompile
  59.     *.EXE           The commands described above
  60.     *.C             C sources
  61.     *.H             C header files
  62.     *.X             C prototype files
  63.  
  64.  
  65. RUNNING A PROGRAM
  66. =================
  67.  
  68. The commands all respond to a "-?" to yield help information, e.g.
  69.  
  70.     MLS -?
  71.  
  72. If a problem occurs while accessing a floppy, a status byte, as returned
  73. from the PC BIOS, is displayed.  Some of the most probable codes are:
  74.  
  75.       2     Address mark not found
  76.       4     Sector not found
  77.       8     DMA overrun
  78.      16     Uncorrectable CRC error
  79.      32     General controller failure (probably disk is unformatted)
  80.      64     Seek failure
  81.     128     Device not ready
  82.  
  83. Only the last one is recoverable by you.
  84.  
  85.  
  86. DISK DEVICES SUPPORTED
  87. ======================
  88.  
  89. This package currently services only floppy disk drives.  It determines,
  90. through trial and error, the geometry of the inserted disk.  The actual
  91. type of DRIVE is not determined (e.g. it cannot distinguish between the
  92. two 720KB possibilities), but this doesn't matter as only the DISK
  93. geometry is important.
  94.  
  95. The possibilites recognized are:
  96.  
  97.         disk        heads   tracks  sectors
  98.     --------------  -----   ------  -------
  99.     160 KB 5.25"      1       40       8    rare
  100.     320 KB 5.25"      2       40       8    less rare
  101.     360 KB 5.25"      2       40       9    DSSD
  102.     720 KB 5.25"      2       80       9    popular in Europe?
  103.     1.2 MB 5.25"      2       80      15    DSDD
  104.     720 KB 3.5"       2       80       9    low density
  105.     1.4 MB 3.5"       2       80      18    high density
  106.  
  107.  
  108. RECOMPILING
  109. ===========
  110.  
  111. The sources and makefile have been successfully used (under MSDOS) with:
  112.  
  113.     OPUS Make 5.11    (the follow-on to NDMAKE)
  114.     Microsoft C 5.1
  115.     Turbo C 2.0
  116.  
  117. To recompile, examine the makefile to insure it is suitable for your
  118. environment.  In particular, comment out the group of macro statements
  119. at the top to select either the Microsoft or Turbo environment.
  120.  
  121. All the executables are produced by:
  122.  
  123.     MAKE
  124.  
  125.  
  126. SPECIAL THANKS
  127. ==============
  128.  
  129. I want to acknowledge the help, advice and patience of:
  130.  
  131.     Chris G. Sylvain    cgs@umd5.umd.edu
  132.  
  133. He got me off my duff to clean up the package and to encourage me
  134. to plan for and begin work on a more feature-rich version.  He also
  135. was the guinea pig for working out bugs and usability problems.
  136.  
  137.  
  138. CONTACT
  139. =======
  140.  
  141. Please address all communications to one of the following places:
  142.  
  143.     Steve Harrold,
  144.     620 Brenda Lee Drive,
  145.     San Jose CA   95123
  146.  
  147.     also:  swh@hpesf.cup.hp.com
  148.     also   408/447-5580 (daytime)
  149.  
  150.  
  151. I hope MINDOS proves useful to all of you, and that you will
  152. communicate your feedback me, especially ideas for the next version.
  153.  
  154.  
  155. ---
  156. swh, 05 apr 91
  157.